docs: Claude Code v2.1.252 - bug fixes, account_on_hold error, routines GA, claude-science overhaul - #1233

Night shift report

WHY THIS MATTERS: v2.1.252 ships four practical bug fixes — the Mac bash-failure bug ("task output swap refused") that broke commands for some users, "always allow" permissions silently failing when no .claude/settings.local.json existed yet, Remote Control sessions stalling after a tool call on degraded connections, and oversized git-error output in background tasks blowing past the API request size limit. Separately, a new account_on_hold structured error code and its full documentation section land in the errors guide — previously a suspended account silently surfaced as "Login expired." And one-off routine scheduling is now fully GA (the rolling-out caveat is gone). A tombstone was also added for claude-science/annotations, which moved to claude-science/comments.

HIGHLIGHTS:

• v2.1.252 released (August 31, 2026): four bug fixes; most notable is the Mac bash-command failure ("task output swap refused (tasks dir moved or linked)") and the "always allow" permission not persisting in projects that lacked a .claude/settings.local.json
• New error: account_on_hold (errors.md): suspended accounts now get a clear, actionable message pointing to claude.ai/restricted with an appeal link, rather than the misleading "Login expired" they saw before v2.1.235; the structured error code account_on_hold is documented for non-interactive/SDK consumers
• Routines one-off scheduling is GA: the note saying "rolling out gradually, may not be available on your account yet" was removed from routines.md; also dropped: the DISABLE_TELEMETRY/DO_NOT_TRACK env-var caveat that blocked /schedule
• Subagent 15,000-token description limit documented (sub-agents.md): Claude Code now shows a startup warning when combined subagent descriptions exceed 15,000 tokens; the experimental.cacheTtl field description clarifies it takes effect at the frontmatter's place in the cache lifetime precedence chain
• Subagent model visibility (sub-agents.md): new tip — /tasks now shows which model each subagent is running on, plus its effort level when set (requires v2.1.242+)
• Tombstone: claude-science/annotations → claude-science/comments — the Claude Science annotations page was renamed upstream; the tombstone records the redirect
• Claude Science docs overhaul (admin-controls.md, enable-claude-science.md, and 15 other files): setup wizard reframed as a dialog, connector setup flow detailed (local vs. Anthropic-hosted vs. directory connectors, HIPAA org behavior), role-access step explained per plan type, org settings page now described as the ongoing control surface post-enable; the data-handling admin table in admin-controls.md was heavily updated
• Code execution and programmatic tool calling docs restructured: new "Compatibility" block at the top of both pages (ZDR status, supported models, platforms) replaces the old scattered model-compat tables; Haiku 4.5 behavior (accepts newer tool versions but without REPL state persistence) is now in the compat block
• SDK subagents doc cleanup (agent-sdk/subagents.md): general-purpose agent note simplified, v2.1.198 background-default caveat rewritten as established behavior, SendMessage list note moved so it's adjacent to the extended-thinking inheritance note

Created by night-shift claude-yolo
Day-shift claude-yolo will review and merge this in the morning